package com.ruoyi.system.service;

import com.ruoyi.system.domain.SysUserFace;

/**
 * 人脸识别服务接口
 *
 * @author ruoyi
 */
public interface ISysFaceService {

    /**
     * 验证人脸，返回匹配的用户ID
     *
     * @param faceImageBase64 人脸图片Base64编码
     * @return 匹配的用户ID，无匹配则返回null
     * @throws Exception 处理异常
     */
    Long verifyFace(String faceImageBase64) throws Exception;

    /**
     * 保存用户人脸信息
     *
     * @param userId 用户ID
     * @param faceImageBase64 人脸图片Base64编码
     * @throws Exception 处理异常
     */
    void saveFaceInfo(Long userId, String faceImageBase64) throws Exception;

    /**
     * 根据用户ID删除人脸信息
     *
     * @param userId 用户ID
     */
    void deleteFaceInfo(Long userId);

    /**
     * 根据用户ID查询人脸信息
     *
     * @param userId 用户ID
     * @return 人脸信息
     */
    SysUserFace selectUserFaceByUserId(Long userId);
}
